package com.expert.miniapp.dao;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * UserMapper - 用户数据访问接口
 *
 * @author System
 * @since 2025-01-14
 */
@Mapper
public interface UserMapper {

    /**
     * 插入新用户
     *
     * @param user 用户对象
     * @return 影响行数
     */
    int insert(User user);

    /**
     * 根据用户ID查询用户
     *
     * @param userId 用户ID
     * @return 用户对象
     */
    User selectById(@Param("userId") String userId);

    /**
     * 根据微信OpenID查询用户
     *
     * @param wechatOpenid 微信OpenID
     * @return 用户对象
     */
    User selectByWechatOpenid(@Param("wechatOpenid") String wechatOpenid);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户对象
     */
    User selectByUsername(@Param("username") String username);

    /**
     * 更新用户信息
     *
     * @param user 用户对象
     * @return 影响行数
     */
    int update(User user);

    /**
     * 更新最后登录时间
     *
     * @param userId 用户ID
     * @return 影响行数
     */
    int updateLastLoginAt(@Param("userId") String userId);

    /**
     * 查询今天创建的用户数量
     *
     * @return 用户数量
     */
    int countTodayUsers();

    /**
     * 软删除用户
     *
     * @param userId 用户ID
     * @return 影响行数
     */
    int softDelete(@Param("userId") String userId);
}
